Repository navigation
fix(ENG-57298): use absolute URLs for llms.txt links - #613
Conversation
/llms.txt and /llms-full.txt are generated by Mintlify at serve time, so they are not files in the repo and the link-rot check flags them on every PR. Point the 3 links in design-system.mdx and llms-index.mdx at the live https://www.cometchat.com/docs/ URLs instead. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WEaVigCRBjkftm78T25MQA
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
ketanyekale
left a comment
There was a problem hiding this comment.
Approving on Ketan's instruction after review at 8a08fe5.
Verdict: APPROVE — no blocking findings.
The diagnosis is correct: /llms.txt and /llms-full.txt are generated by Mintlify at serve time, so they are not repo files and the link checker counts them as missing. The verification method is sound — mint broken-links on unmodified main returned the same 3, confirming they are pre-existing on main rather than introduced by any PR. link-rot now passes on this branch.
Absolute https://www.cometchat.com/docs/ links are already the existing convention in at least 20 other files (ai-agents.mdx, cli.mdx, agent-skills.mdx, several UI Kit overviews), so this sets no new precedent.
Non-blocking, worth a follow-up: in llms-index.mdx the original was [/docs/llms.txt](/llms.txt) — link text saying /docs/, href saying /. If Mintlify does not prefix the docs base path onto root-relative hrefs, those links were broken for readers too, not only for the checker. Worth checking whether other root-relative links in the repo carry the same mismatch; the three fixed here may be a sample rather than the set.
Description
The Mintlify
link-rotcheck fails on every docs PR (e.g. #609) with 3 broken links that live onmain, not in the PR:design-system.mdx:[llms.txt](/llms.txt)llms-index.mdx:[/docs/llms.txt](/llms.txt)and[/docs/llms-full.txt](/llms-full.txt)Mintlify generates
/llms.txtand/llms-full.txtat serve time. They aren't files in the repo, so the link checker treats them as missing. This PR points the 3 links at the live absolute URLs (https://www.cometchat.com/docs/llms.txtandhttps://www.cometchat.com/docs/llms-full.txt). The link text and the pages they reach don't change.Verification
mint broken-linkson unmodifiedmain(dda3e08):Found 3 broken links in 2 files, the same 3 as the PR docs(angular): Offline Support for the Angular UI Kit #609 check run.mint broken-linkson this branch:success no broken links found.curlon both absolute URLs returns200 text/plain.Related Issue(s)
Multica: ENG-57298 (https://multica.cometchat-staging.com/rnd-team/issues/ENG-57298)
Type of Change
Checklist
Additional Information
Two lines changed in two files. Once this merges, open docs PRs need a rebase or re-run to pick up a green link-rot check.
🤖 Generated with Claude Code
https://claude.ai/code/session_01WEaVigCRBjkftm78T25MQA